Node / meshtastic / Meshtastic-Android / files / core / ui / src / commonMain / kotlin / org / meshtastic / core / ui / component / LoraSignalIndicator.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tf0883e@fileTb4b4b4:Te6edf3SuppressTb4b4b4(Ta5d6ff"Ta5d6ffMagicNumberTa5d6ff"Tb4b4b4)

Tff7b72package T7ee787org.meshtastic.core.ui.component

Tff7b72import T7ee787androidx.compose.foundation.layout.Arrangement

Tff7b72import T7ee787androidx.compose.foundation.layout.Column

Tff7b72import T7ee787androidx.compose.foundation.layout.ExperimentalLayoutApi

Tff7b72import T7ee787androidx.compose.foundation.layout.FlowRow

Tff7b72import T7ee787androidx.compose.foundation.layout.Row

Tff7b72import T7ee787androidx.compose.foundation.layout.fillMaxSize

Tff7b72import T7ee787androidx.compose.foundation.layout.fillMaxWidth

Tff7b72import T7ee787androidx.compose.foundation.layout.padding

Tff7b72import T7ee787androidx.compose.foundation.layout.size

Tff7b72import T7ee787androidx.compose.material3.Icon

Tff7b72import T7ee787androidx.compose.material3.MaterialTheme

Tff7b72import T7ee787androidx.compose.material3.MaterialTheme.colorScheme

Tff7b72import T7ee787androidx.compose.material3.Text

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.Stable

Tff7b72import T7ee787androidx.compose.ui.Alignment

Tff7b72import T7ee787androidx.compose.ui.Modifier

Tff7b72import T7ee787androidx.compose.ui.graphics.Color

Tff7b72import T7ee787androidx.compose.ui.unit.dp

Tff7b72import T7ee787org.jetbrains.compose.resources.DrawableResource

Tff7b72import T7ee787org.jetbrains.compose.resources.StringResource

Tff7b72import T7ee787org.jetbrains.compose.resources.stringResource

Tff7b72import T7ee787org.jetbrains.compose.resources.vectorResource

Tff7b72import T7ee787org.meshtastic.core.common.util.MetricFormatter

Tff7b72import T7ee787org.meshtastic.core.model.snrLimit

Tff7b72import T7ee787org.meshtastic.core.resources.Res

Tff7b72import T7ee787org.meshtastic.core.resources.bad

Tff7b72import T7ee787org.meshtastic.core.resources.fair

Tff7b72import T7ee787org.meshtastic.core.resources.good

Tff7b72import T7ee787org.meshtastic.core.resources.ic_signal_cellular_4_bar

Tff7b72import T7ee787org.meshtastic.core.resources.ic_signal_cellular_alt

Tff7b72import T7ee787org.meshtastic.core.resources.ic_signal_cellular_alt_1_bar

Tff7b72import T7ee787org.meshtastic.core.resources.ic_signal_cellular_alt_2_bar

Tff7b72import T7ee787org.meshtastic.core.resources.none_quality

Tff7b72import T7ee787org.meshtastic.core.resources.rssi

Tff7b72import T7ee787org.meshtastic.core.resources.signal

Tff7b72import T7ee787org.meshtastic.core.resources.signal_quality

Tff7b72import T7ee787org.meshtastic.core.resources.snr

Tff7b72import T7ee787org.meshtastic.core.ui.theme.StatusColors.StatusGreen

Tff7b72import T7ee787org.meshtastic.core.ui.theme.StatusColors.StatusOrange

Tff7b72import T7ee787org.meshtastic.core.ui.theme.StatusColors.StatusRed

Tff7b72import T7ee787org.meshtastic.core.ui.theme.StatusColors.StatusYellow

Tff7b72import T7ee787org.meshtastic.core.ui.util.LocalModemPreset

Tff7b72import T7ee787org.meshtastic.proto.Config.LoRaConfig.ModemPreset

T8b949e// Fixed-threshold SNR colors retained for contexts without an active preset (e.g. traceroute hop coloring in

T8b949e// AnnotatedStrings). Per-node signal quality uses preset-relative thresholds instead — see [determineSignalQuality].

Tff7b72const Tff7b72val Te6edf3SNR_GOOD_THRESHOLD Tff7b72= Tff7b72-T79c0ff7f

Tff7b72const Tff7b72val Te6edf3SNR_FAIR_THRESHOLD Tff7b72= Tff7b72-T79c0ff1T79c0ff5f

Tff7b72const Tff7b72val Te6edf3RSSI_GOOD_THRESHOLD Tff7b72= Tff7b72-T79c0ff1T79c0ff1T79c0ff5

Tff7b72const Tff7b72val Te6edf3RSSI_FAIR_THRESHOLD Tff7b72= Tff7b72-T79c0ff1T79c0ff2T79c0ff6

T8b949e// SNR offsets (dB) below a preset's demodulation floor that delimit the quality bands, matching Meshtastic-Apple's

T8b949e// getSnrColor(): within 5.5 dB below the limit is FAIR, within 7.5 dB is BAD, further down is NONE.

Tff7b72private Tff7b72const Tff7b72val Te6edf3SNR_FAIR_OFFSET Tff7b72= T79c0ff5.5f

Tff7b72private Tff7b72const Tff7b72val Te6edf3SNR_BAD_OFFSET Tff7b72= T79c0ff7.5f

Tf0883e@Stable

Tff7b72enum Tff7b72class T56d364QualityTb4b4b4(

Tf0883e@Stable Tff7b72val Te6edf3nameResTb4b4b4: Te6edf3StringResourceTb4b4b4,

Tf0883e@Stable Tff7b72val Te6edf3iconTb4b4b4: Te6edf3DrawableResourceTb4b4b4,

Tf0883e@Stable Tff7b72val Te6edf3colorTb4b4b4: Tf0883e@Composable Tb4b4b4(Tb4b4b4) Tff7b72-Tff7b72> Te6edf3ColorTb4b4b4,

Tb4b4b4) Tb4b4b4{

Te6edf3NONETb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3none_qualityTb4b4b4, Te6edf3ResTb4b4b4.Te6edf3drawableTb4b4b4.Te6edf3ic_signal_cellular_alt_1_barTb4b4b4, Tb4b4b4{ Te6edf3colorSchemeTb4b4b4.Te6edf3StatusRed Tb4b4b4}Tb4b4b4)Tb4b4b4,

Te6edf3BADTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3badTb4b4b4, Te6edf3ResTb4b4b4.Te6edf3drawableTb4b4b4.Te6edf3ic_signal_cellular_alt_2_barTb4b4b4, Tb4b4b4{ Te6edf3colorSchemeTb4b4b4.Te6edf3StatusOrange Tb4b4b4}Tb4b4b4)Tb4b4b4,

Te6edf3FAIRTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3fairTb4b4b4, Te6edf3ResTb4b4b4.Te6edf3drawableTb4b4b4.Te6edf3ic_signal_cellular_altTb4b4b4, Tb4b4b4{ Te6edf3colorSchemeTb4b4b4.Te6edf3StatusYellow Tb4b4b4}Tb4b4b4)Tb4b4b4,

Te6edf3GOODTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3goodTb4b4b4, Te6edf3ResTb4b4b4.Te6edf3drawableTb4b4b4.Te6edf3ic_signal_cellular_4_barTb4b4b4, Tb4b4b4{ Te6edf3colorSchemeTb4b4b4.Te6edf3StatusGreen Tb4b4b4}Tb4b4b4)Tb4b4b4,

Tb4b4b4}

T8b949e/**

* Displays the `snr` and `rssi` color coded based on the signal quality, along with a human readable description and

* related icon.

*/

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalLayoutApiTff7b72::Te6edf3classTb4b4b4)

Tf0883e@Composable

Tff7b72fun Td2a8ffNodeSignalQualityTb4b4b4(

Te6edf3snrTb4b4b4: Tffa657FloatTb4b4b4,

Te6edf3rssiTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3modifierTb4b4b4: Te6edf3Modifier Tff7b72= Te6edf3ModifierTb4b4b4,

Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Te6edf3LocalModemPresetTb4b4b4.Te6edf3currentTb4b4b4,

Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3quality Tff7b72= Te6edf3determineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPresetTb4b4b4)

Te6edf3FlowRowTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3modifierTb4b4b4,

Te6edf3itemVerticalAlignment Tff7b72= Te6edf3AlignmentTb4b4b4.Te6edf3CenterVerticallyTb4b4b4,

Te6edf3horizontalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3SpaceBetweenTb4b4b4,

Tb4b4b4) Tb4b4b4{

Te6edf3SnrTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPreset Tff7b72= Te6edf3modemPresetTb4b4b4)

Te6edf3RssiTb4b4b4(Te6edf3rssiTb4b4b4)

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Ta5d6ff"Tffd700${Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3signalTb4b4b4)Tffd700}Ta5d6ff Tffd700${Te6edf3stringResourceTb4b4b4(Te6edf3qualityTb4b4b4.Te6edf3nameResTb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3labelSmallTb4b4b4,

Te6edf3maxLines Tff7b72= T79c0ff1Tb4b4b4,

Tb4b4b4)

Te6edf3IconTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3sizeTb4b4b4(Te6edf3SIZE_ICON_DPTb4b4b4.Te6edf3dpTb4b4b4)Tb4b4b4,

Te6edf3imageVector Tff7b72= Te6edf3vectorResourceTb4b4b4(Te6edf3qualityTb4b4b4.Te6edf3iconTb4b4b4)Tb4b4b4,

Te6edf3contentDescription Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3signal_qualityTb4b4b4)Tb4b4b4,

Te6edf3tint Tff7b72= Te6edf3qualityTb4b4b4.Te6edf3colorTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72const Tff7b72val Te6edf3SIZE_ICON_DP Tff7b72= T79c0ff1T79c0ff6

T8b949e/** Displays the `snr` and `rssi` with color depending on the values respectively. */

Tf0883e@Composable

Tff7b72fun Td2a8ffSnrAndRssiTb4b4b4(Te6edf3snrTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3rssiTb4b4b4: Tffa657IntTb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Te6edf3LocalModemPresetTb4b4b4.Te6edf3currentTb4b4b4) Tb4b4b4{

Te6edf3RowTb4b4b4(Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3fillMaxWidthTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3horizontalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3SpaceBetweenTb4b4b4) Tb4b4b4{

Te6edf3SnrTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPreset Tff7b72= Te6edf3modemPresetTb4b4b4)

Te6edf3RssiTb4b4b4(Te6edf3rssiTb4b4b4)

Tb4b4b4}

Tb4b4b4}

T8b949e/** Displays a human readable description and icon representing the signal quality. */

Tf0883e@Composable

Tff7b72fun Td2a8ffLoraSignalIndicatorTb4b4b4(

Te6edf3snrTb4b4b4: Tffa657FloatTb4b4b4,

Te6edf3modifierTb4b4b4: Te6edf3Modifier Tff7b72= Te6edf3ModifierTb4b4b4,

Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Te6edf3LocalModemPresetTb4b4b4.Te6edf3currentTb4b4b4,

Te6edf3contentColorTb4b4b4: Te6edf3Color Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3colorSchemeTb4b4b4.Te6edf3onSurfaceTb4b4b4,

Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3quality Tff7b72= Te6edf3determineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPresetTb4b4b4)

Te6edf3ColumnTb4b4b4(

Te6edf3verticalArrangement Tff7b72= Te6edf3ArrangementTb4b4b4.Te6edf3CenterTb4b4b4,

Te6edf3horizontalAlignment Tff7b72= Te6edf3AlignmentTb4b4b4.Te6edf3CenterHorizontallyTb4b4b4,

Te6edf3modifier Tff7b72= Te6edf3modifierTb4b4b4.Te6edf3fillMaxSizeTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3paddingTb4b4b4(T79c0ff8.Te6edf3dpTb4b4b4)Tb4b4b4,

Tb4b4b4) Tb4b4b4{

Te6edf3IconTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3ModifierTb4b4b4.Te6edf3sizeTb4b4b4(Te6edf3SIZE_ICON_DPTb4b4b4.Te6edf3dpTb4b4b4)Tb4b4b4,

Te6edf3imageVector Tff7b72= Te6edf3vectorResourceTb4b4b4(Te6edf3qualityTb4b4b4.Te6edf3iconTb4b4b4)Tb4b4b4,

Te6edf3contentDescription Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3signal_qualityTb4b4b4)Tb4b4b4,

Te6edf3tint Tff7b72= Te6edf3qualityTb4b4b4.Te6edf3colorTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3TextTb4b4b4(

Te6edf3text Tff7b72= Ta5d6ff"Tffd700${Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3signalTb4b4b4)Tffd700}Ta5d6ff Tffd700${Te6edf3stringResourceTb4b4b4(Te6edf3qualityTb4b4b4.Te6edf3nameResTb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3labelSmallTb4b4b4,

Te6edf3color Tff7b72= Te6edf3contentColorTb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tf0883e@Composable

Tff7b72fun Td2a8ffSnrTb4b4b4(Te6edf3snrTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3modifierTb4b4b4: Te6edf3Modifier Tff7b72= Te6edf3ModifierTb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Te6edf3LocalModemPresetTb4b4b4.Te6edf3currentTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3colorTb4b4b4: Te6edf3Color Tff7b72= Te6edf3determineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPresetTb4b4b4)Tb4b4b4.Te6edf3colorTb4b4b4.Te6edf3invokeTb4b4b4(Tb4b4b4)

Te6edf3TextTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3modifierTb4b4b4,

Te6edf3text Tff7b72= Ta5d6ff"Tffd700${Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3snrTb4b4b4)Tffd700}Ta5d6ff Tffd700${Te6edf3MetricFormatterTb4b4b4.Te6edf3snrTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3decimalPlaces Tff7b72= T79c0ff2Tb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4,

Te6edf3color Tff7b72= Te6edf3colorTb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3labelSmallTb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tf0883e@Composable

Tff7b72fun Td2a8ffRssiTb4b4b4(Te6edf3rssiTb4b4b4: Tffa657IntTb4b4b4, Te6edf3modifierTb4b4b4: Te6edf3Modifier Tff7b72= Te6edf3ModifierTb4b4b4, Te6edf3labelTb4b4b4: Tffa657String Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3rssiTb4b4b4)Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3colorTb4b4b4: Te6edf3Color Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3rssi Tff7b72> Te6edf3RSSI_GOOD_THRESHOLDTb4b4b4) Tb4b4b4{

Te6edf3QualityTb4b4b4.Te6edf3GOODTb4b4b4.Te6edf3colorTb4b4b4.Te6edf3invokeTb4b4b4(Tb4b4b4)

Tb4b4b4} Tff7b72else Tff7b72if Tb4b4b4(Te6edf3rssi Tff7b72> Te6edf3RSSI_FAIR_THRESHOLDTb4b4b4) Tb4b4b4{

Te6edf3QualityTb4b4b4.Te6edf3FAIRTb4b4b4.Te6edf3colorTb4b4b4.Te6edf3invokeTb4b4b4(Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3QualityTb4b4b4.Te6edf3BADTb4b4b4.Te6edf3colorTb4b4b4.Te6edf3invokeTb4b4b4(Tb4b4b4)

Tb4b4b4}

Te6edf3TextTb4b4b4(

Te6edf3modifier Tff7b72= Te6edf3modifierTb4b4b4,

Te6edf3text Tff7b72= Ta5d6ff"Tffd700$Te6edf3labelTa5d6ff Tffd700${Te6edf3MetricFormatterTb4b4b4.Te6edf3rssiTb4b4b4(Te6edf3rssiTb4b4b4)Tffd700}Ta5d6ff"Tb4b4b4,

Te6edf3color Tff7b72= Te6edf3colorTb4b4b4,

Te6edf3style Tff7b72= Te6edf3MaterialThemeTb4b4b4.Te6edf3typographyTb4b4b4.Te6edf3labelSmallTb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e/**

* Rates link quality from SNR relative to the active modem preset's demodulation floor ([ModemPreset.snrLimit]). A

* given SNR means different things per preset — e.g. -15 dB is excellent on LongSlow (SF12) but unusable on ShortFast

* (SF7) — so a fixed threshold mis-rates most presets.

*

* RSSI is intentionally not considered: without the noise floor it cannot indicate whether a signal is demodulable, so

* SNR-versus-preset-limit is the meaningful measure (it is still shown to the user via [Rssi]). See #5446.

*

* A null/unknown [modemPreset] falls back to the LongFast default limit.

*/

Tff7b72fun Td2a8ffdetermineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4: Tffa657FloatTb4b4b4, Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset?Tb4b4b4)Tb4b4b4: Te6edf3Quality Tb4b4b4{

Tff7b72val Te6edf3limit Tff7b72= Te6edf3modemPresetTb4b4b4.Te6edf3snrLimit

Tff7b72return Tff7b72when Tb4b4b4{

Te6edf3snr Tff7b72> Te6edf3limit Tff7b72-Tff7b72> Te6edf3QualityTb4b4b4.Te6edf3GOOD

Te6edf3snr Tff7b72> Te6edf3limit Tff7b72- Te6edf3SNR_FAIR_OFFSET Tff7b72-Tff7b72> Te6edf3QualityTb4b4b4.Te6edf3FAIR

Te6edf3snr Tff7b72>Tff7b72= Te6edf3limit Tff7b72- Te6edf3SNR_BAD_OFFSET Tff7b72-Tff7b72> Te6edf3QualityTb4b4b4.Te6edf3BAD

Tff7b72else Tff7b72-Tff7b72> Te6edf3QualityTb4b4b4.Te6edf3NONE

Tb4b4b4}

Tb4b4b4}